*********************************************************************
*                         ServeRAID Manager                         *
*                            README.TXT                             *
*                           Version 9.30                            *
*********************************************************************

CONTENTS
________

1.0  Overview
     1.1  New features in this release
     1.2  Supported operating systems
     1.3  Supported controllers and enclosures
2.0  Installation and setup notes
     2.1  General
     2.2  Linux
     2.3  Solaris
     2.4  VMWare
     2.5  Windows silient un-installation
     2.6  OS/2 software levels
3.0  Troubleshooting tips
     3.1  General
     3.2  Microsoft Windows
     3.3  Novell NetWare
     3.4  Linux
     3.5  ServeRAID Manager running as a plug-in
4.0  Web Site and support phone number
5.0  Trademarks and notices
6.0  Disclaimer
7.0  Licensing


1.0  Overview
_____________

  The ServeRAID Manager program is used to configure, administer, and
  monitor IBM ServeRAID, Adaptec HostRAID, and other integrated RAID
  controllers.
  
  1.1  New features in this release
  _________________________________
 
    o  Option to enable/disable automatic failover.

    o  Parallel operation for back ground tasks.

    o  Clear defunct option, to remove defunct state of a hard drive.

    o  Fix for UART log truncation, raid_agent script modification with 'awk' utility.
	
    NOTE: See ServeRAID Manager change history (readme.chg)
                              
  1.2  Supported operating systems
  ________________________________

  You can use the ServeRAID Manager program with the following
  operating systems:
     
    o  Microsoft Windows:
       
       + Microsoft Windows Server 2008 SP2/R2
       + Windows Vista - All versions (32-bit/64-bit)
       + Windows 2000 Server/Advanced Server
       + Windows Server 2003 Workstation/Server/Enterprise Server         
       + Windows Server 2003 for EM64T*
       + Microsoft Windows XP Professional 
       + Microsoft Windows XP Professional for EM64T
              
    o  Linux:

       + Red Hat Enterprise Linux 3 AS/ES/WS*
       + Red Hat Enterprise Linux 3 AS/ES for EM64T*       
       + Red Hat Enterprise Linux 4 AS/ES/WS*                  
       + Red Hat Enterprise Linux 4 AS/ES for EM64T*
       + Red Hat Enterprise Linux 5 AS/ES/WS*                  
       + Red Hat Enterprise Linux 5 AS/ES for EM64T* 
       + SuSE Linux Enterprise Server 9*
       + SuSE Linux Enterprise Server 9 for EM64T*
       + SuSE Linux Enterprise Server 10 
       + SuSE Linux Enterprise Server 10 for EM64T
	
    o  Netware:

       + Novell Netware 6.5 EP*
       
    o  UnixWare:

       + SCO UnixWare 7.1.3 and 7.1.4
    
    o  OpenServer:
    
       + SCO OpenServer 5.0.6a and 5.0.7
    
    o  OS/2:

       + IBM OS/2 WARP Server for e-business
       
    o  Solaris:
     
       + Sun Solaris 10 Update 1
       
    o  VMWare:
     
       + VMWare 3.0
       
       
    *Out-of-box and current quarterly update or service pack
  

  Minimum System Requirements:  Intel Pentium Compatible 1.2 GHz processor
                                512 MB RAM
                                80 MB hard disk drive space
                                256 color video mode


  1.3  Supported controllers and enclosures
  _________________________________________

  You can use the ServeRAID Manager program with the following
  controllers and enclosures:

    o  IBM ServeRAID-8s Serial Attached SCSI (SAS) controller
    o  IBM ServeRAID-8k/8k-l Serial Attached SCSI (SAS) controller
    o  IBM ServeRAID-8i Serial Attached SCSI (SAS) controller
    o  IBM ServeRAID-7t SATA controller
    o  IBM ServeRAID-7k Ultra320 SCSI controller
    o  IBM ServeRAID-7e/8e (Adaptec HostRAID) controllers
    o  IBM ServeRAID-6i/6i+ Ultra320 SCSI controller
    o  IBM ServeRAID-6M Ultra320 SCSI controller
    o  IBM ServeRAID-5i Ultra320 SCSI controller
    o  IBM ServeRAID-4H/4M/4L/4Mx/4Lx Ultra160 SCSI controllers
    o  LSI-1030 integrated RAID controller
    

2.0  Installation and setup notes
_________________________________

  2.1  General
  ____________
  
    o  Refer to the IBM ServeRAID Installation Guide (INSTALL.PDF) in 
       the /BOOKS directory on the "IBM ServeRAID Support" CD for 
       installation information.
       
    o  The ServeRAID Manager generates log files automatically to
       assist in tracking ServeRAID activity. The log files are
       created in the directory where the ServeRAID Manager is
       installed.  
     
       * RaidEvt.log  - Contains the information reported in the
                        ServeRAID Manager event viewer for all
                        local and remote systems.
  
       * RaidEvtA.log - Contains the information reported in the
                        ServeRAID Manager event viewer for the
                        local system.
                         
       * RaidNot.log  - Contains the information reported in the
                        Notification Manager event viewer.
                                                
       * RaidErr.log  - Contains Java messages generated by the
                        ServeRAID Manager.
                      
       * RaidErrA.log - Contains Java messages generated by the
                        ServeRAID Manager agent.
                        
       Information written to these files is appended to the existing
       files to maintain a history.  However, if any of the files reach
       a size of 5 Mbytes, the file is copied to a new file with 
       the extension .OLD and the original (that is, the LOG file) is 
       deleted and recreated.  If a .OLD file already exists, the 
       existing .OLD file is destroyed.
    
    o  You can configure ServeRAID Manager settings on other servers
       exactly as they are configured on one server. To replicate the 
       ServeRAID Manager tree and notification list, do the following:     
  
       1.  Install the ServeRAID Manager on one server.
  
       2.  Start the ServeRAID Manager. Using the 'Add remote system' 
           action, define the servers for your tree.
  
       3.  Open the Notification Manager. Using the 'Add system' 
           action, define the notification list.
  
       4.  Exit the ServeRAID Manager.
  
       5.  Copy the following files onto a diskette from the directory
           where the ServeRAID Manager is installed:
  
           RaidMSys.ser --> to replicate the tree
           RaidNLst.ser --> to replicate the notification list
           RaidSMTP.ser --> to replicate the SMTP e-mail notification list
           RaidJob.ser  --> to replicate the jobs in the Task Scheduler
  
       6.  Install the ServeRAID Manager on the other servers.
  
       7.  Copy the files from the diskette into the directory where
           the ServeRAID Manager is installed on the other servers.
  
  
  2.2  Linux
  __________
  
    o  To install the ServeRAID Manager on Red Hat Enterprise Linux, 
       AS 3 or WS 3, you must install two packages from the Red Hat 
       installation CD:
     
       - compat-libstdc++-7.3-2.96.122.i386.rpm
       - compat-libstdc++--devel-7.3-2.96.122.i386.rpm
                   
       NOTE:  The version string in the file name may be different 
              than above. Be sure to check the version string on the 
              Red Hat CD.
     
       For example, type:
            
       rpm --install /mnt/compat-libstdc++-7.3-2.96.122.i386.rpm
            
       where mnt is the mount point of the CD-ROM drive.            

    o  To install the ServeRAID Manager on Red Hat Enterprise Linux 4
       for EM64T, you must install the following package from the Red 
       Hat installation CD:
       
       - xorg-x11-deprecated-libs-6.8.1-23.i386.rpm 

       NOTE:  The version string in the file name may be different 
              than above. Be sure to check the version string on 
              the Red Hat CD.
	
   o   To install ServeRAID Manager on Red Hat Enterprise Linux 5,
       you must install the following package from the Red Hat
       installation CD:
       
       -  libXp-1.0.0-8.386.rpm      (32-Bit)
       
       NOTE:  The 32 bit libXp-1.0.0-8.386.rpm must be used for
       	      both 32/64 bit operating system
	

    o  To install the ServeRAID Manager on Novell Linux Desktop 9 
       Service Pack 1 for 64-bit systems, you must install two   
       packages from the Novell Linux installation CD:
     
       - liblcms-devel-1.12-55.2.x86_64.rpm
       - compat-32bit-9-200502081830.x86_64.rpm
                   
       NOTE:  The version string in the file name may be different 
              than above. Be sure to check the version string on the 
              Novell Linux CD.

         
  2.3  Solaris
  ____________

    o  To install the ServeRAID Manager on Sun Solaris 10 (i386), 
       you must preinstall the following packages from the Solaris 
       installation CDs:
       
       -  SUNWcslr Core Solaris Libraries (Root)
       -  SUNWcsl Core Solaris (Shared Libs)
       -  SUNWlibmsr Math & Microtasking Libraries (Root)
       -  SUNWgccruntime GCC Runtime libraries 
       
       You must also install the following LSI Logic drivers before the
       ServeRAID Manager:
     
       -  ITImpt LSI Logic FusionMPT(tm) drivers
       -  LSI Logic driver V5.06 or greater 

       Follow the installation instructions for the driver in the 
       driver readme.

       NOTE: If you do not follow the instructions in the driver 
             readme, the ServeRAID Manager will not be able to manage
             the LSI controller.
       
    o  To install the ServeRAID Manager on Sun Solaris: 

       1.  Unpack the installer package. For example, type:
            
           #gunzip RaidMan-8.30.00.i386.pkg.tar.gz
           #tar -xvf RaidMan-8.30.00.i386.pkg.tar

       2.  Use the 'pkgadd' command to install the ServeRAID Manager 
           package:
       
           #pkgadd -d .
            
           NOTE:  The '.' represents the current working directory--the
                  directory where the package was unpacked.
               
       3.  Follow the instructions in the installer program.

    o  To run the ServeRAID Manager on Sun Solaris:

       1.  Go to /usr/RaidMan
     
       2.  Type: ./RaidMan.sh


  2.4  VMWare
  ___________

    To install the ServeRAID Manager program on VMWare: 

    1. Insert the IBM ServeRAID Application CD into the CD-ROM drive. 

    2. Type the following command to install the 32-bit Linux   
       ServeRAID Manager on the VMWare ESX Server: 

       rpm -ivh RaidMan-9.00.i386.rpm 

    3. Install the ServeRAID Manager on a Windows or Linux machine.
 
    4. From the Windows or Linux client, connect to the ServeRAID   
       Manager agent on the VMWare ESX Server using the management 
       client.
 
    NOTES: 

    o  The ServeRAID agent on the VMWare ESX Server cannot be 
       monitored from a guest operating system. 

    o  The VMWare ESX 3.0 firewall must have specific ports enabled 
       for incoming and outgoing traffic. The default ports ServeRAID  
       Manager uses for connection are 34570 to 34580. 

        
  2.5  Windows silent un-installation
  _____________________________________
  
    Use the silent un-installation procedure to un-install the ServeRAID
    Manager software from a batch script. Silent un-installation uses 
    a command line to un-install the software without messages or user  
    interaction. 

    The procedure has two basic steps: 

      1. Find the un-install values for ServeRAID Manager in the Windows 
         Registry
      
      2. Create the silent un-install command
    
    Step 1 - Find un-install values in the Windows Registry
    
    To determine the un-install string, look in the registry under: 
    
    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall 
    
    Search for the string "ServeRAID Manager". 
    
    Then, look for the key "UninstallString". This value contains the string
    needed to un-install ServeRAID Manager silently. 
    
    The following list shows the typical values for recent ServeRAID 
    Manager releases. 
    
    NOTE: You should still check the registry to verify the value for 
          your release.
    
    SRM 9.30 - {7126EAD4-199B-483F-AD46-36BB388C6D4B}
    SRM 9.20 - {7126EAD4-199B-483F-AD46-36BB388C6D4B}
    SRM 9.00 - {7126EAD4-199B-483F-AD46-36BB388C6D4B}
    SRM 8.40 - {ABD84E9C-3A32-4644-A388-BA6F9F79A0C7}
    SRM 8.30 - {B96EB83B-D9ED-400E-B2C3-36870C36189A}
    SRM 8.25 - {B96EB83B-D9ED-400E-B2C3-36870C36189A}
    SRM 8.20 - {1877513F-AF66-4DA5-9548-AEC596B1BFB0}
    SRM 8.10 - {37095634-FCE6-41F1-90FB-AC4D43A7084D}
    SRM 8.00 - {37095634-FCE6-41F1-90FB-AC4D43A7084D}
             
    Step 2 - Create the silent un-install command
    
    To create a release-specific silent un-install command, add the /qn
    option to the UninstallString, and launch the 'msiexec' command 
    with 'start /wait'.
    
    Example (SRM 8.40):
    
    	start /wait MsiExec.exe /X{ABD84E9C-3A32-4644-A388-BA6F9F79A0C7} /qn
    
    By using start /wait, the command prompt will not return until
    the software is completely un-installed. 

    Refer to the following article at the Microsoft support site for 
    a detailed explanation of the 'msiexec' command line options:
    	
    http://msdn2.microsoft.com/En-US/library/aa367988.aspx <http://msdn2.microsoft.com/En-US/library/aa367988.aspx 


  2.6  OS/2 software levels
  _________________________
    
    This ServeRAID release supports the following levels of code
    for OS/2 storage management and device driver software:
  
    - OS/2 device driver 7.00       
    - IPSSEND 7.00       
    - ServeRAID Manager 6.11
       
    Because the OS/2 device driver supports only the 7.00 level of
    code, you may see version mismatches in the ServeRAID Manager 
    RaidCfg.log file for BIOS, firmware, and device driver levels.  


3.0  Troubleshooting tips
_________________________

  3.1  General
  ____________
  
    o  The ServeRAID Manager will not start on a server that is using
       only 16 colors.

       The ServeRAID Manager supports a minimum of 256 colors.  You
       must switch the video mode from 16 colors to a mode with at
       least 256 colors.

    o  If the ServeRAID Manager console does not repaint correctly,
       select the View->Refresh menu item to repaint the screen.

    o  If you initialize one or more drives in a flashcopy source array,  
       the flashcopy target cannot be deleted. To avoid creating a flashcopy 
       drive that cannot be deleted, you must delete the flashcopy drive 
       first, before you initialize the drives in the source array.

  
  3.2  Microsoft Windows
  ______________________
  
    o  If the network connection is disconnected while the ServeRAID 
       Manager Agent is running, the agent cannot communicate with the
       ServeRAID Manager console. As a result, the ServeRAID Manager  
       will not report task status in the Event viewer. Reestablish 
       network commmunication; then, restart the ServeRAID Manager 
       agent and console.    

    o  The ServeRAID Manager is distorted and hard to read.
    
       The Java Virtual Machine has a problem with the 256-color 
       palette.  Set the Display Properties Settings to a color
       mode with greater than 256 colors. 

    o  If a channel on the LSI 1030 controller does not contain any
       SCSI devices, the controller will not appear in the ServeRAID
       Manager.
  
    o  When you shut down Windows, you see the message "unexpected
       shutdown".
       
       Windows displays this message if the ServeRAID Manager Agent fails 
       to exit within 3 seconds. It has no affect on file I/O or other
       system operations and can be ignored.
 
  
  3.3  Novell NetWare
  ___________________
  
    o  When starting the NetWare operating system, the ServeRAID
       agent fails to start.  A message "The ServeRAID agent failed
       to start" displays when starting the server.
   
       The server is unable to load the ServeRAID agent.  This is
       usually caused by loading Java before the ServeRAID agent.
       In the file Autoexec.ncf, move the line "LOAD RAIDAGNT -BOOT"
       so that it is before any lines that reference Java.

    o  Due to incompatible versions of the ServeRAID Manager NLMs,
       there can be only one ServeRAID agent running at a time.

       If the stand-alone version of the ServeRAID agent is running
       already, the IBM Director Extension ServeRAID sub-agent cannot
       be started successfully, and vice versa. 
       
     
  3.4  Linux
  __________
        
    o  If you cannot connect to a local or remote ServeRAID Manager  
       installed on a Linux system, verify that the TCP/IP hosts file  
       is configured properly.
      
       1.  Open the /etc/hosts file.
       
           NOTE:  The following is an example:
           
                  127.0.0.1 localhost.localdomain localhost matrix
       
       2.  If the hostname of the system is identified on the line
           with 127.0.0.1, you must create a new host line.
       
       3.  Remove the hostname from the 127.0.0.1 line.
       
           NOTE:  The following is an example:
           
                  127.0.0.1 localhost.localdomain localhost

       4.  On a new line, type the IP address of the system.
       
       5.  Using the Tab key, tab to the second column and enter the 
           fully qualified hostname.
           
       6.  Using the Tab key, tab to the third column and enter the 
           nickname for the system.
           
           NOTE:  The following is an example of a completed line:

                  1.1.1.1 matrix.localdomain matrix
                  
                  where 1.1.1.1 is the IP address of the server and
                  matrix is the hostname of the server.
           
       7.  Restart the server for changes to take effect.
              
    o  On certain versions of Linux, you may see messages concerning font 
       conversion errors. Font configuration under X-Windows is a known 
       JVM problem. It does not affect the proper operation of the  
       ServeRAID Manager software. To suppress these messages, add the 
       following line to your .Xdefaults file:
       
       stringConversionWarnings: False
                     
    o  Some pop-up identification boxes include complete window frames   
       when running the ServeRAID Manager in bootable-CD mode. These
       pop-ups may run off the side of the screen due to the extra width 
       of the window frame. This is a known problem of the fvwm window 
       manager on the CD.
                                 
    o  On rare occasions, the online help system may generate a Java 
       exception. This is due to a known problem in the HTML rendering 
       section of JFC/Swing.
              
  
  3.5  ServeRAID Manager running as a plug-in
  ___________________________________________
  
    o  A 'plug-in', as referred to in this file and the ServeRAID
       Manager online help, specifically refers to IBM Director.
    
    o  If the server you are managing appears as a '?' icon in the 
       ServeRAID Manager tree, the server might not have any 
       ServeRAID controllers installed.  Check the server
       configuration and restart the plug-in.             
  

4.0 Web Sites and support phone number
______________________________________

   
  o  You can download new and updated files for the IBM ServeRAID 
     products from the IBM Support Web site:
  
     http://www.ibm.com/support/us/en

  o  For the latest list of supported operating systems, see the IBM
     Server Proven - SCSI and RAID Controllers Web site:
     
     http://www-03.ibm.com/servers/eserver/serverproven/compat/us/xseries/controllers/matrix.html 

     For supported operating systems on legacy (non-shipping)
     controllers, see:
     
     http://www-03.ibm.com/servers/eserver/serverproven/compat/us/indexsp.html 

  o  With the original purchase of an IBM hardware product, you have
     access to extensive support coverage.  During the IBM hardware
     product warranty period, you may call the IBM Personal Computer
     HelpCenter (1-800-IBM-SERV in the U.S.) for hardware product
     assistance covered under the terms of the IBM hardware warranty.  
     

5.0 Trademarks and notices
__________________________

  IBM is a registered trademark of International Business Machines Corporation
  in the United States and other countries.

  Adaptec and HostRAID are trademarks or registered trademarks of Adaptec, Inc
  in the United States and other countries.

  Linux is a registered trademark of Linus Torvalds in the United States and
  other countries.

  Microsoft, Windows, Windows Server, and Windows Vista are trademarks or
  registered trademarks of Microsoft Corporation in the United States and other
  countries.

  Novell, NetWare, and SUSE are registered trademarks of Novell, Inc. in the
  United States and other countries.

  Red Hat and the Shadowman logo are registered trademarks of Red Hat, Inc. in
  the United States and other countries.

  Other company, product, and service names may be trademarks or service marks
  of others.


6.0 Disclaimer
______________

  THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.
  IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED,
  INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS
  FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE
  INFORMATION IN THIS DOCUMENT.  BY FURNISHING THIS DOCUMENT, IBM
  GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS.

  Note to U.S. Government Users -- Documentation related to
  restricted rights -- Use, duplication or disclosure is subject
  to restrictions set forth in GSA ADP Schedule Contract with
  IBM Corporation.


7.0 Licensing
_____________

(c) 1999, 2007 Adaptec, Inc. All Rights Reserved. 

This software contains the valuable trade secrets of Adaptec or its
licensors. The software is protected under international copyright
laws and treaties. This software may only be used in accordance with 
the terms of its accompanying license agreement.

No part of this publication may be reproduced, stored in a retrieval
system, or transmitted in any form or by any means, electronic,
mechanical, photocopying, recording or otherwise, without prior
written consent of Adaptec, Inc., 691 South Milpitas Blvd.,
Milpitas, CA 95035.

